home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
PDPerror.z
/
PDPerror
Wrap
Text File
|
1998-10-30
|
4KB
|
67 lines
PPPPDDDDPPPPeeeerrrrrrrroooorrrr((((3333)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo PPPPDDDDPPPPeeeerrrrrrrroooorrrr((((3333))))
NNNNAAAAMMMMEEEE
PDPerror, PDErrorString - obtain libpod execution error messages
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ppppoooodddd....hhhh>>>>
vvvvooooiiiidddd PPPPDDDDPPPPeeeerrrrrrrroooorrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ssss))));;;;
cccchhhhaaaarrrr**** PPPPDDDDEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg((((iiiinnnntttt eeeerrrrrrrr____ccccooooddddeeee))));;;;
eeeexxxxtttteeeerrrrnnnn iiiinnnntttt PPPPDDDDeeeerrrrrrrrnnnnoooo;;;;
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_P_D_P_e_r_r_o_r prints error messages to standard error in a format similar to
the standard C library function _p_e_r_r_o_r(_3_C). _P_D_E_r_r_o_r_S_t_r_i_n_g returns the
error string corresponding to the _l_i_b_s_p_o_o_l error code specified by
_e_r_r__c_o_d_e. The function is similar to the C library function
_s_t_r_e_r_r_o_r(_3_C).
If an error occurs during a _l_i_b_p_o_d function call, the global error
variable _P_D_e_r_r_n_o will be set with an error code. The symbolic names for
these error codes are defined in _p_o_d._h.
The value of _P_D_e_r_r_n_o is used by _P_D_P_e_r_r_o_r as an index to a table of error
messages. _P_D_e_r_r_n_o can be passed to _P_D_E_r_r_o_r_S_t_r_i_n_g to obtain the _l_i_b_p_o_d
error message corresponding to the error code.
A call to _P_D_P_e_r_r_o_r will print the user-supplied string _s followed by a
colon (:), a space, and the error message corresponding to the current
value of _P_D_e_r_r_n_o. If the string _s is the NULL string (""), no colon or
space will be printed, only the error message.
To be of most use, a call to _P_D_P_e_r_r_o_r should be made immediately
following the _l_i_b_p_o_d function which failed.
PPPPRRRRIIIINNNNTTTTEEEERRRR OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNNAAAALLLL EEEERRRRRRRROOOORRRRSSSS
The _P_D_P_e_r_r_o_r function only provides information about _l_i_b_p_o_d function
execution errors. Information about printer operational errors is not
provided by _P_D_P_e_r_r_o_r but rather by querying the printer database using
the _P_D_R_e_a_d_S_t_a_t_u_s and _P_D_R_e_a_d_I_n_f_o functions.
NNNNOOOOTTTTEEEE
The global variables _P_D_e_r_r_l_i_s_t and _P_D_n_e_r_r should no longer be referenced.
The function _P_D_E_r_r_o_r_S_t_r_i_n_g _s_h_o_u_l_d _b_e _u_s_e_d.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
PDReadStatus(3), PDReadInfo(3), libpod(3)
PPPPaaaaggggeeee 1111